home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / fractals / fracblank / fracblank.doc < prev    next >
Text File  |  1994-11-17  |  10KB  |  190 lines
  1. ============================== FracBlank 2.2 ==============================
  2. ===========================================================================
  3. A  screen  blanker  utility  written  by Olaf `Olsen' Barthel.  © Copyright
  4. 1991-92 by Olaf `Olsen' Barthel, Giftware, all rights reserved.
  5.    Cosmic  flame  fractal  code  derived from original xlock program source
  6. code, © Copyright 1988-91 by Patrick J.  Naughton.
  7.    No  guarantee  of any kind is made that the program(s) described in this
  8. document are 100% reliable.  You use this material on your own risk.
  9.  
  10. ================================= Purpose ================================
  11. ===========================================================================
  12. FracBlank is yet another custom screen blanker created to live in symbiosis
  13. with  Kickstart  2.04   (Kickstart  37.175  and  Workbench  37.67 or higher
  14. required)  and  the  Commodities Exchange toolkit, similar to the `Blanker'
  15. program to be found in the Tools/Commodities drawer, just more wonderful.
  16.    Apart  from the usual job (turning the screen black after a given period
  17. of  time to prevent the phosphorus of your monitor from burning in) it will
  18. draw  some neat patterns while mouse and keyboard are inactive.  Instead of
  19. animating  polygons,  the  Amiga  logo,  the Boing!  ball or other assorted
  20. items, real plane or cosmic flame fractals will be drawn.
  21.    The algorithm employed comes from the September 1986 issue of Scientific
  22. American;  some  of  you  who  are  familiar with X11 will know it from the
  23. popular  `xlock'  program.  The patterns created may remind you of spiders'
  24. webs,  lace  or  even  Chladni's  patterns  formed by grains of sand strewn
  25. across  a  vibrating surface.  When I received a copy of the original xlock
  26. program  source code I decided to add another fractal type:  cosmic flames.
  27. The  patterns created by this algorithm ressemble cosmic nebuli, ferns, the
  28. traces  left by subatomic particles or the fruitless attempts of a lecturer
  29. in particle physics to do action-painting.
  30.  
  31. ============================== Installation ===============================
  32. ===========================================================================
  33. I  have  provided  two  versions of `FracBlank', one has been compiled with
  34. standard  Motorola  FFP  support  (this one will run on any Amiga which has
  35. Kickstart 2.04+ installed), the other one will only work on Amiga computers
  36. which  have  an  MC68020/030  and  an  FPU68881/882  (or MC68040) installed
  37. (namely the A3000/T/UX line of computers).
  38.    Drop the approriate file into your WbStartup drawer or add the line `run
  39. >nil:  <nil:  fracblank' to your `s:user-startup' file.
  40.    There  are  a  number  of  command  line  switches  available which also
  41. correspond  to  tooltype  entries  to  be  changed/created by selecting the
  42. approriate icon and choosing the Workbench item `Information...':
  43.  
  44. CX_PRIORITY...... The  Cx priority to assign this tool to.  You may want to
  45.                   change  this  value  if  there is more than one Commodity
  46.                   tool    running   to   use  the  same  key  sequences  as
  47.                   `FracBlank'.   The  one  which  has  the  higher priority
  48.                   assigned will receive the keystrokes first.
  49.  
  50. CX_POPKEY........ The  keys to press to open the `FracBlank' control panel.
  51.                   The  control  panel allows you to set the hotkeys, adjust
  52.                   the timeouts, to  select the hotkeys and to terminate the
  53.                   program.
  54.  
  55. CX_POPUP......... This   is  a  boolean  switch  which  determines  whether
  56.                   `FracBlank' is to open the control panel on startup or to
  57.                   remain quiet.  Place `yes' here to open it.
  58.  
  59. BLANKSCREEN...... The keys to depress to force the screen blanker to become
  60.                   active.  If the blanker is already active, pressing these
  61.                   keys will cause the pattern to change.
  62.                      When  in `Random' mode, a pattern change only concerns
  63.                   the currently active fractal type, it will not change the
  64.                   fractal type.
  65.  
  66. FRACTAL.......... The  program supports two fractal types and a random mode
  67.                   which  will select either of these.  To select real plane
  68.                   fractals,  place  `REAL'  or `REALPLANE' here.  To select
  69.                   cosmic  flames,  use  `COSMICFLAME' or `FLAME'; any other
  70.                   name will select the random mode.
  71.  
  72. COLOUR........... The   program   support  three  kinds  of  colour  modes,
  73.                   monochrome mode, a static 32 colour palette and a cycling
  74.                   75  colour  palette.   To select one of these, use `MONO'
  75.                   for  monochrome  mode, `STATIC' for static 32 colour mode
  76.                   and `CYCLE' for cycling 75 colour mode.
  77.  
  78. KEYBLANK......... This   is  a  boolean  switch  which  determines  whether
  79.                   `FracBlank'  is  to turn off the mouse pointer whenever a
  80.                   key  is pressed, `on', `off', `yes' and `no' are possible
  81.                   arguments.
  82.  
  83. SCREENTIMEOUT.... The  number  of seconds to wait before the screen blanker
  84.                   is  activated.   This  period of time must elapse without
  85.                   any  mouse movements or keys being pressed.  If the value
  86.                   placed here is zero, screen blanking will be disabled.
  87.                      You  may  either enter the number of seconds (60, 120,
  88.                   etc.)  or  provide  a  string in the format mm:ss (11:30,
  89.                   12:25, etc.).
  90.  
  91. MOUSETIMEOUT..... The number of seconds to wait before the mouse pointer is
  92.                   turned  off.  If the value placed here is zero, the mouse
  93.                   pointer  will  not  be  turned  off automatically after a
  94.                   certain period of time.
  95.                      You  may  either enter the number of seconds (60, 120,
  96.                   etc.)  or  provide  a  string in the format mm:ss (11:30,
  97.                   12:25, etc.).
  98.  
  99. PATTERNTIMEOUT... While  the  screen  blanker  is  running,  the  number of
  100.                   seconds  to wait before changing the fractal pattern.  If
  101.                   the  value  placed  here  is  zero, a single pattern will
  102.                   remain.
  103.                      You  may  either enter the number of seconds (60, 120,
  104.                   etc.)  or  provide  a  string in the format mm:ss (11:30,
  105.                   12:25, etc.).
  106.                      When  in `Random' mode, a pattern change only concerns
  107.                   the currently active fractal type, it will not change the
  108.                   fractal type.
  109.  
  110.    Running  `FracBlank'  twice  will cause it to open the control panel; to
  111. terminate  `FracBlank'  send  it  a  ^C signal (such as by `break 3 c' with
  112. `FracBlank'  running  as  CLI  task  3) or conjure up the control panel and
  113. press the `Quit' button.
  114.  
  115.    Although  some  of  the  patterns  generated  by  the  program will look
  116. symmetrical,  it  will make no attempt to centre them on the screen (as far
  117. as  my  knowledge  goes,  this  would  either require precalculation of the
  118. fractals or a severe redefinition of a bucket-full of mathematical axioms).
  119.  
  120. ==================== Author's Request & Gift-Ware fee =====================
  121. ===========================================================================
  122. By  releasing  this program and the accompanying source code as Gift-Ware I
  123. do  not  place any obligations on you, feel free to share this program with
  124. your  friends (and enemies) to study and to learn from it.  But, should you
  125. feel the need to make any contributions, send them to:
  126.  
  127.                                Olaf Barthel
  128.                              Brabeckstrasse 35
  129.                             D-3000 Hannover 71
  130.  
  131.                         Federal Republic of Germany
  132.  
  133.    I  am  looking for old Infocom games ("Arthur and the quest for the holy
  134. grail",  "Border  zone",  "Bureacracy", "Cutthroats", "Leather Goddesses of
  135. Phobos",  "Nord  and  Bert  couldn't  make  head or tail of it", "Plundered
  136. Hearts",  "Seastalker",  "Sherlock  -  The Riddle of the Crown Jewels", and
  137. "Trinity";  MS-DOS and Atari ST versions of t